home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / src / Games / xboing / README < prev    next >
Encoding:
Text File  |  1995-07-14  |  5.7 KB  |  155 lines
  1. XBoing Version 1.7 
  2. ==================
  3.  
  4. Updated: 27th August 1993
  5.  
  6.  
  7. Description
  8. -----------
  9.  
  10. XBoing is a simple blockout type game where you have a paddle which you use to
  11. bounce a ball around the game area blowing up blocks with the ball. You win by
  12. obtaining points for each block destroyed and each level completed. The person
  13. with the highest score wins.
  14.  
  15. XBoing was started like many other projects to learn Xlib better. I had the 
  16. XPM library and was already using it in a Motif application. I thought that it
  17. would be cool to have nice colour pictures/animations in an Xlib game. So I 
  18. did. Without the XPM library I would be still playing with the colours I think.
  19.  
  20. Please read the manual page as the manual has some important game play 
  21. information. Now I have warned you so don't complain if something doesn't 
  22. seem to be correct or that another breakout game did it like that or this. :-)
  23.  
  24.  
  25. Requirements
  26. ------------
  27.  
  28. The XPM library. Version 2.3 upwards tested. 3.2g is fine. Not tested below 2.3
  29. Suggest you use 3.2g which is available everywhere now. 
  30.  
  31. A COLOUR X display. I may fix it to use other visuals later. ie: grey. mono
  32.  
  33. An ansi or non-ansi compiler. Ansi is better, try gcc.
  34. A decent GRUNT box to run XBoing. No network travel if possible! :-)
  35.  
  36. Also note that if you are on a Sun machine the xnews server is not the
  37. quickest and you may experience delays in the game due to its heavy use
  38. of pixmaps etc. I suggest playing it with the MIT X Server - hassle I know
  39. if you use other Sun software that requires news etc.
  40.  
  41. Note: It will always be a bit slower on a network so playing on the host
  42.       machine will give the best results. I have tuned the game for my
  43.       SparcStation 2 and it runs very fast. I cannot test the game on
  44.       other machines other the some Xterms and SGI Indigo's.  Disclamier.
  45.  
  46. This program doesn't have an Xdefaults file and does not use Motif or Xt. It
  47. is a plain XLib program. It runs VERY fast on my computer which is a sparc II.
  48. If it is slow then check out the README.problems doco.
  49.  
  50. Please don't mail me and ask why it is slow unless you have read the -
  51. README.problems
  52.  
  53.  
  54. Where do I get it from
  55. ----------------------
  56.  
  57. Via anonymous ftp from ftp.x.org  in the contrib directory. 
  58. The most recent version is xboing1.7-tar.Z. It may appear on other mirrors
  59. that mirror ftp.x.org or whatever.
  60.  
  61. Please do not try to obtain it from my own machine. ftp.x.org is quicker.
  62. The game is NOT kept in the ftp account on my machine so don't try please.
  63.  
  64.  
  65. Installation/Building game
  66. --------------------------
  67.  
  68. Please read the file called INSTALL. It is important to read this file.
  69. Don't forget to get the XPM library and compile it up first!
  70.  
  71.  
  72. Usage
  73. -----
  74.  
  75. The game does have command line options so check them out. 'xboing -help'
  76.  
  77. The colourmap is taken over as I need all the colours. Sorry but thats the
  78. problem with only 256 colourmap entries. I cannot see a problem with this.
  79.  
  80. The colourmap is released afterwards and should return you to your lovely
  81. colour scheme. If it doesn't please let me know.
  82.  
  83.  
  84. Developement
  85. ------------
  86.  
  87. Xboing was developed on a SparcStation 2 with 48meg memory and a 19" colour
  88. display using the MIT X11R5 X server, Motif Window Manager. I used x11ups
  89. for debugging - excellent tool - well done. Sunos 4.1.2 sun4c. Compiled using
  90. gcc with warnings on and also tested using the Sun cc compiler (non ansi).
  91.  
  92. Reference books: All of O'Reilly Series, X & Motif Quick reference guide
  93. Graphics: Titles done on Amiga using Deluxe Paint IV, converted using pbmplus
  94.           tools and xpm image touch ups with "pixmap".
  95. Sounds:   Mainly from sounds.sdus.edu and also from other places.
  96.  
  97.  
  98. Special Thanks
  99. --------------
  100.  
  101. Really Special thanks to Arnaud Le Hors (lehors@sophia.inria.fr) for the
  102. wonderful XPM library and for making it free :-).
  103.  
  104. Thanks for a some cool backgrounds found in Anthony's Icons V1.3 (new ones!)
  105.     Anthony Thyssen - anthony@cit.gu.edu.au
  106.  
  107. The comp.windows.x newsgroup netters for help over the past few years. See
  108. the README.changes doco for inline lisitings of the helpers.
  109.  
  110. Thankyou to all those who have contributed. Especially the beta testers here
  111. at CATT. It's hard to do any work around here!
  112.  
  113.     Michael Stone, Andrew Cassin, Iain Lim, Tim Liddelow, Peter Cupit
  114.     Craig McNaughton, Chris Fu, David Kershaw, Geoff Lambourne
  115.     Paul McGregor, my 3 cats ...
  116.  
  117.  
  118. Patches to XBoing
  119. -----------------
  120.  
  121. Patches are great and welcomed. Please do as others have and either send them
  122. to me or post them to news. Please do NOT place them on ftp.x.org and
  123. make it look like I put it there. I got heaps of mail saying a certain patch
  124. didn't work and I didn't even know it existed. I think it is common courtesy
  125. to send me some email about what is going on etc.
  126.  
  127. Also - you can do whatever you like at your own site but don't send a patch
  128. that changes the flag on the presentation screen. :-)
  129.  
  130.  
  131. Suggestions/Bug fixes
  132. ---------------------
  133.  
  134. I have had many suggestions and bug fixes. I cannot list all the names of the
  135. people who have helped as it would be a big list and I wouldn't want to
  136. leave anyone out. Thankyou to all those who have mailed - you know. ;-)
  137.  
  138. See the README.changes doco for more info.
  139.  
  140.  
  141. Grovel Bit
  142. ----------
  143.  
  144. If anyone is feeling really generous or kind they can send money, equipment,
  145. cars, travel vouchers or anything for that matter to my humble self and I 
  146. will be very happy. ;-) If that's all a bit much then a friendly email will
  147. do fine. Hope you have fun bouncing your balls. Stay cool.
  148.  
  149. Surface Mail: 1/17 Albert Rd, North Warrandyte, Victoria, Australia, 3113
  150.  
  151. --------------------------------------------------------------------------
  152. Justin C. Kibell - email: jck@citri.edu.au     Phone: +61 3 282 2456
  153. CITRI - CATT - Australia - Melbourne - Victoria - 723 Swanston St, Carlton
  154. Systems Programmer - X11 Developer - Motif Head - Volunteer Rescuer - VICSES
  155.